home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Monster Media 1996 #15
/
Monster Media Number 15 (Monster Media)(July 1996).ISO
/
wildcat
/
qwkhold1.zip
/
QWK2HOLD.DOC
< prev
next >
Wrap
Text File
|
1996-05-17
|
11KB
|
273 lines
QWKHOLD1.ZIP by James Mardis @ Fidonet 1:322/746 5/11/96
This package of programs were written to allow callers the ability to
turn ON/OFF the automatic making of QWK mail packets.
If you read nothing else, be sure and modify the QWK2HOLD.CFG before
you try and run this set of programs. I'd suggest reading all of the
QWK2HOLD.DOC (this) file at least once before you try to use the program.
All of these programs are compiled using WcCode 4.12. The source code
uses programming commands that did not exist in earlier versions.
The source code is included with this package so you can make changes
or even try to re-write the code to work for an older version of WcCode
if you so wish.
REGISTRATION: There is none. I would not mind a note from you indicating
that you are using the program but the note is entirely
at your own discression.
LOGON2.WCX is the program that will notify callers they have new QWK mail
and let them download it. It can also be renamed LOGON1.WCX with out
having to recompile it but my personal preference is to have it in the
number two position myself.
QWK2HOLD.WCX is used to allow callers to turn on/off the making of QWK mail
packets. I added it to my system as letter "A" in my mail menu using the
word A)utomate QWK. It does not take much prompting for people to find
out it will save them much online time. It will use one of the User
COMMENT( ) fields in the caller's record. The QWK.CFG determines which
COMMENT field is used. Please make sure you pick a Comment(?) value that
is not in use by some other program.
An optional file called QWK2HOLD.TXT can be created by the Sysop if you
do not want to use the default text the callers will read when they
ask for more information. If QWK2HOLD.TEXT is found it will be used in
place of the the encoded text.
QWK2MAKE.WCX is to be run as an part of a batch program. It requires
that the environment variable WCPORTID be set to 0 (zero) in order to
function correctly.
QWK2WAIT.BAT is a batch program that QWK2MAKE.WCX will create if a
caller is still online when the program attempts to make that user's
mail packets. You can use it in a Wildcat! "event", some periodic
BATCH program you run, or ignore it. If it still exists when QWK2MAKE
is run again it will be deleted or a new one created if the need still
exists. Its purpose is to give you one last chance to make mail packets
for those callers who stayed online during processing.
QWK2HOLD.CFG is the configuration file that you MUST modify before the
programs will work properly for you.
An example of the configuration file is shown below along with the
descriptions of what the lines are used for and need to contain.
C:\MAIL\
8
C:\WILDCAT\QWK\
COMMENT(5)
NEWUSER
NO SEC2
26
20
3615200
0
0E
0F
0B
0C
C:\WILDCAT\FLAGS\
FidoNet mail is being processed at this time.
WildNet mail is being processed at this time.
SAF-Net mail is being processed at this time.
Mail run #4 is being processed at this time.
Slow road ahead, Mail processing is in progress.
All entries in the .CFG file after line #20 are ignored and could be deleted.
The configuration file, QWK2HOLD.CFG breaks down as follows:
Line #1, Complete PathName where WCMAIL QWK stores mail packets,
such as C:\WILDCAT\MAIL\QWK\.
NOTE: Line #1 and Line #3 must not be the same value.
Line #2, File area number for QWK Mail that was chosen in the Makewild
QWK Mail area. Your callers should not have access to this
download area.
Line #3, Complete PathName where QWK2 can store all user mail packets.
NOTE: Line #1 and Line #3 must not be the same value.
NOTE: This area is not to be part of or created by Makewild.
This subdirectory should not be in use by any other program.
Line #4, Valid values are COMMENT(1) through COMMENT(5) exactly as shown.
The right and left parentheses around the number are mandatory.
The actual value found in the user's COMMENT(?) field will
contain either QWK2 ON, QWK2 OFF or be blank. Make sure the
COMMENT(?) value you pick for this program is not in use by
any other program.
Line #5, Security Profile #1 to exclude from operating this program.
I use this to bar NEWUSER from this program
while allowing them access to other WCX programs.
If not used set it to NO SEC1.
Line #6, Security Profile #2 to exclude from operating this program.
If not used set it at NO SEC2.
Line #7 Maximum number of QWK packets a caller can have waiting for pickup.
Valid values are 1 to 26.
Line #8 Maximum number of days to keep stored QWK packets.
Valid values are 1 to 365.
Line #9 Maximum allowed storage space for user packets in bytes, but
a minimum of 1 packet is allowed regardless of this value.
Valid values are 1 to 2147483, this is in Kbytes.
Line #10 Conference number where user messages are to be sent.
Messages will be sent with the Private flag turned on.
Line #11 Prompt colors normal for Text and Background, leave off @ symbols.
Default two character code is 0E.
Line #12 Prompt colors normal for Highlighted Text.
Default two character code is 0B.
Line #13 Prompt colors normal for Packet size and elsewhere.
Default two character code is 0C.
Line #14 Prompt colors normal for warning messages.
Default two character code is 0E.
Line #15 Path to inbound mail flag, Path to where QWK2MA?.FLG's.
This line is just the path to the directory where the flags
in lines 16 through 20 are to be created in, if used. It
is up to you to modify your batch program(s) to actually
create the flag(s) you want activated.
Line #16 Text to display when Mail Flag #1 (QWK2MA1.FLG) is found.
Line #17 Text to display when Mail Flag #2 (QWK2MA2.FLG) is found.
Line #18 Text to display when Mail Flag #3 (QWK2MA3.FLG) is found.
Line #19 Text to display when Mail Flag #4 (QWK2MA4.FLG) is found.
Line #20 Text to display when Mail Flag #5 (QWK2MA5.FLG) is found.
A short four line BATCH file "example" is shown below which will give you
an example of how you would change your existing mail BATCH program so
that mail packets are made after your mail has been processed.
ECHO Turn on Mail Processing Flag #3 > C:\WILDCAT\FLAGS\QWK2MA3.FLG
CD\WILDCAT
SET WCPORTID=0
WILDCAT /R QWK2MAKE.WCX
The batch example can be added to your existing mail processing batch.
The QWK2MA1.FLG file being made can be used to alert callers that not
all mail has finished being processed yet. You need to provide the same
path information to the QWK2MA3.FLG as you have put in line #15 of the
QWK2HOLD.CFG file. Most people put this flag line at the beginning of
their mail BATCH program. The flag file, if used, will be deleted by
QWK2MAKE.WCX when it is finished.
QWK2 FLAGS
The creation of the mail flag(s) used in LOGON2.WCX and QWK2HOLD.WCX
is left up to the Sysop. He or she needs to include a line(s) of text in
the BATCH program used to run the QWK2MAKE program to create the flag(s).
You do this by adding a line such as shown below:
ECHO Turn on Flag #3 > (path)\QWK2MA3.FLG
You need to replace the (path) with the path used in the configuration
line #15 for this to work right.
MAKEWILD LOCAL QWK Mailer Limits
A couple of items that will assist you in managing things here. You will
need to go into MakeWild and set the LOCAL QWK mailer limits to what
ever size mail packets you want to allow callers to create. These will be
the maximum values, not necessarily what the individual callers choose to
use. They may set their values lower if they so choose.
DOS PATH Statement
Your WILDCAT home directory needs to be included in the path statement
for the DOS session you are operating this set of programs in.
You can check for this by going to dos and then typing the command
SET (and ending it with a carriage return)
This will show you any or all environment variables you have active with
one of them starting with PATH=. It is in this PATH= string that you must
find your Wildcat home directory. If it is missing you will need to
add it to the PATH. One way is to copy down the existing PATH as it is and
at the beginning of the batch program which starts your Wildcat session add
SET PATH=(and retype what was found when you ran the SET command), at the
semicoln ";" (add one if the PATH line does not end with one) and the PATH
for your Wildcat home directory.
An example is SET PATH=(origional path);/WILDCAT
You may end the path with a semicoln or not as DOS does not care which
way it ends.
COLORS
The color code chart showing the code combinations is shown below.
Hex Value Screen Color Background Forground
0 Black Normal Normal
1 Blue Normal Normal
2 Green Normal Normal
3 Cyan Normal Normal
4 Red Normal Normal
5 Magenta Normal Normal
6 Brown Normal Normal
7 White Normal Normal
8 Black Blinks FG Hi Intensity
9 Blue Blinks FG Hi Intensity
A Green Blinks FG Hi Intensity
B Cyan Blinks FG Hi Intensity
C Red Blinks FG Hi Intensity
D Magenta Blinks FG Hi Intensity
E Brown Blinks FG Hi Intensity
F White Blinks FG Hi Intensity
This means a code of 04 would be a black background and Red letters.
0C would be black background with Bright Red letters.
8C would be black background with flashing Bright Red letters, OR so
the WcCode manual says. I let you try the color code combinations
on your own as they are dependent on the monitors used.
OLDER VERSIONS
These programs were released in an earlier version under the name of
QWK2PACK.ZIP. Any copies of the earlier versions should be deleted when
found. If you are upgrading you should delete all of the older programs
as they are not compatible with the new versions.
WARRANTY
These programs carry no Warranty or Guarantee whatsoever. You use these
programs at your own risk. The original Author shall NOT be held
responsible for any damages whatsoever as to the result or use of these
programs.